$Id: README,v 1.11 1999/07/02 17:33:41 build Exp $
Copyright (C) 1997 - 1998, Hewlett-Packard Company, all rights reserved.
Written by Keith Bayern

This directory contains example MATLAB programs (m files).

You need MATLAB 5, on HP-UX 10.20, Windows95 or WindowsNT to run these.

The files hpe1432.dll for the PC or hpe1432.mexhp7 on HP-UX 10.2 must be in
MATLAB's path for the MATLAB programs to work correctly with your system.  Also 
on the HP-UX system the VISA library must be explicitly loaded(hpe1432_loadvisa) 
and locked(hpe1432('-lock')) prior to calling any hpe1432 commands.

One way to do this is to create a matlab/bin directory and copy these files to 
it.  To copy the mexfile library to your matlab/bin directory:

On Windows-95 or Windows-NT

    Copy  C:\Hpe1432\examples\matlab\hpe1432.dll to your Matlab\bin directory.

On HP-UX 10.2

    Copy /opt/e1432/examples/matlab/hpe1432.mexhp7 to your matlab/bin
    Copy /opt/e1432/examples/matlab/hpe1432_loadvisa.mexhp7 to your matlab/bin

Then use the the matlab command editpath(or addpath) to add your matlab/bin
directoryto your path.

On the HP-UX system the VISA library must be explicitly loaded and locked prior 
to calling any hpe1432 commands.  The command hpe1432_loadvisa will cause the
VISA library to be loaded and the command hpe1432('-lock') will cause the E1432 
library to be locked in memory, rather than unloaded each run.  Unloading the 
library can cause a crash.  

The addpath, hpe1432_loadvisa, and hpe1432('-lock') commands can be placed in 
the startup.m file for convenience.  See your MATLAB manual for
details on startup files.


This directory contains some example code showing how to use the E1432
Plug & Play Library to communicate with an E1432 module.  Most of these
programs in this directory are all small, so that they will be easily
understood and easy to copy into a real application.

The files in this directory are:


README		The file you are reading now.

Order_4.m

This is the user interface part of the example for performing an Order
Ratio Map measurement using the E1432 with a option AYF tachometer.
There are three files associated with this example (Order_4.m,
Order_4.mat and Order_log.m).  Order_4.m is the user interface and it is
stored with default values for the user inputs.  A tach signal needs to
be connected to tach 1 SNB connector on the front panel.  Four response
channels will be processed with this example.  The data used to create
this example came from a 4 cylinder automobile engine with 2 pulses per
rev on the tach signal.  The responses were accelerometers.

Order_4.mat

Companion file to Order_4.m.  This is the user interface data file that
is used by Order_4.m.  This file was created when the Matlab "guide"
program created the user interface

Order_log.m

This is the Matlab program that gets called when the "Start" button in
the Order_4.m user interface is pressed.  It sets up the E1432 to
perform the resampling of the time data into the revolution domain,
performs the measurement and graphs the results.

Burstsine.m

Example program to setup the E1432 with a source option (1D4) to output
a burst sinewave and activate four digitizer channels of the E1432A or
E1433A.  For simplicity of demonstration, connect the source output
(upper right connector on front of module) to channel 1.

Burstrandom.m

Example program to setup the E1432 with a source option (1D4) to output
a burst random waveform and activate four digitizer channels of the
E1432A or E1433A.  For simplicity of demonstration, connect the source
output (upper right connector on front of module) to channel 1.


Scope.m

Very simple example of setting up a E1432A (or E1433A) to activate four
channels and return time data to Matlab for display.

hpe1432_check_status.m

This function decodes error messages when the returned "status"
value from HPE1432A module functions is not zero.

fast_scope.m
	Another scope example.

scope32.m
	A scope example for 32 channels.

srcbarb.m
	Burst arb source example.

srcbrand.m
	Burst random source example.

srcbrandz.m
	Burst zoom random source example.

srcbsine.m
	Burst sine source example.

srccarb.m
	Continuous arb source example.

srcparb.m
	Periodic arb source example.

srcrand.m
	Continuous random source example.

srcrandz.m
	Continuous zoom random source example.

srcsine.m
	Continuous sine source example.

